home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / comm2 / thrtcpb4.lha / ThorTCPBeta / README.FIRST < prev    next >
Text File  |  1995-07-25  |  11KB  |  296 lines
  1. Short: NNTP/SMTP/POP tools for THOR 2.01
  2. Type: comm/mail
  3. Author: Kjell Irgens/Petter Nilsen (thor@hstud6.cs.uit.no)
  4. Uploader: Petter Nilsen (pettern@powertech.no)
  5. Replaces: ThorTCPBeta3.lha
  6. ------------------==================================------------------
  7. 950725
  8.                             ThorTCP Beta 4
  9.  
  10.                    Requires AmigaDOS 2.04 (V37) and
  11.                    THOR 2.01 previously installed.
  12.  
  13.      Copyright © 1995 Ultima Thule Software, All Rights Reserved.
  14.     Authors: Kjell Irgens & Petter Nilsen (thor@hstud6.cs.uit.no)
  15.  
  16. ------------------==================================------------------
  17.  
  18. Disclaimer
  19. ~~~~~~~~~~
  20. We  have  made every effort possible to ensure that this software will
  21. function  as  described,  but  no  warranty  of any kind, expressed or
  22. implied,  is  made  by  us.   We  will not be liable for any direct or
  23. indirect damages to either machinal equipment or mental health arising
  24. from  a failure of the program to operate in the manner desired by the
  25. user.   In  no  event  will  we  be  liable for any loss of profits or
  26. savings.
  27.  
  28. About ThorTCP Beta 4
  29. ~~~~~~~~~~~~~~~~~~~~
  30. These  software  tools  provide an easy way receive and send news/mail
  31. using a TCP/IP connection (like AmiTCP, AS225, MLink, etc). Tools are
  32. provided that should satisfy both shell and GUI users.
  33.  
  34. NOTE:   All  the executables are compiles for AS225.  To use them with
  35. AmiTCP,  you will need to install the socket.library emulation library
  36. that  is included with Grapevine or can be found on Aminet in comm/net
  37. as socketlib10a.lha.
  38.  
  39. GetTCP  is  used  for getting mail and news, while SendTCP is used for
  40. sending  mail  and  news  that you have written, joining and resigning
  41. newsgroups, etc. 
  42.  
  43. ConnectTHOR  is  used  for  integrating  these  programs into a single
  44. program.  It also contain a nice news browser what will let you select
  45. a  newsgroup and download only the articles you want be selecting them
  46. from a list with dragselection.
  47.  
  48. GetTCP  and SendTCP can both be started from shell with arguments that
  49. will  override  the  configuration settings.  If you want, you can run
  50. these automatically from eg.  a startnet script.
  51.  
  52. NOTE:   These  programs are "work in progress" and not all features we
  53. would  like to add is present at this time.  However, we feel that the
  54. programs  are so stable and work so well that they should satisfy most
  55. THOR users.
  56.  
  57. Installation
  58. ~~~~~~~~~~~~
  59. -  Double-click  on the supplied icon for the installation script, and
  60. the   installation   of   the   various   programs   should  be  quite
  61. straightforward.
  62.  
  63. -  Enter  Systems  Config  in  THOR  and  create (or change an already
  64. existing system) with Type set to TCP.  Configure you email address in
  65. the "Userinfo" window.  As "Mail packet", you can enter your username,
  66. and if you have mailpackets in your download dir, they will be parsed.
  67. Otherwise, this is not used by the TCP module itself.
  68.  
  69. -  Click  on  the  "Type  Options" gadget, a window containing various
  70. options will come up.  This window contains the following options:
  71.  
  72.  
  73. -> Mail Server
  74. This  is the server that will be used when sending and receiving mail.
  75. Typing in the name or IP address of your pophost will do.
  76.  
  77. -> Username
  78. This  is  the  username,  the name you log on to you account with.  By
  79. setting  the  checkbox "Get from Systems Config", this login name will
  80. be resolved from your email address configured in THOR.
  81.  
  82. -> Password
  83. This is an optional password.  By setting the "Ask every time" option,
  84. you will be prompted for the password before collecting mail.  This is
  85. the best solution for security reasons.
  86.  
  87. -> POP Port
  88. If  your  pop  server  is on some other port than the default 110, set
  89. this to the correct port.  110 is default.
  90.  
  91. -> Delete mail from POP server
  92. By  setting  this option, the collected mail will be deleted from your
  93. mail  (pop)  host after it's been successfully received by your Amiga.
  94. This  is recommended, or you will most likely get duplicate mail every
  95. time you collect mail.
  96.  
  97. -> Newsserver
  98. Enter  the name or IP address of the newsserver (NNTP server) you will
  99. use to get news from.
  100.  
  101. -> Max days
  102. This is the maximum number of days for news collection.  By using this
  103. option,  you can restrict the age of the news you want to receive.  If
  104. you  collect  news  regulary,  this option can normally be disabled by
  105. selection the "Don't use" option.  Use it when you come home from a 30
  106. days holiday :)
  107.  
  108. -> Date
  109. By  using  this  slider,  you can set the exact date and time for news
  110. collection.   This  date  and  time will be used when getting news, so
  111. that  you will receive all news on the newsserver newer than this date
  112. and  time.   The  "set" gadget must be used for these settings to take
  113. effect.
  114.  
  115. -> Edit Headers
  116. This  option  will  let  you edit custom header fields to be used when
  117. posting  news  or  mail  from  THOR.   Fields  can  include "Reply-To:
  118. <address>",  "Organization:   Not organized", etc.  If THOR is running
  119. when  you  select  this  option, the editor configured in THOR will be
  120. used.   Otherwise,  a name of an editor to use will must be entered in
  121. the requester that comes up.
  122.  
  123. -> Delete Header
  124. Will  delete  the  custom  header file for this system.  Use this with
  125. caution  since there is no way to get it back once it's delete (except
  126. for using DiskSalv or somesuch :)
  127.  
  128. -> Save
  129. Save  the  configuration.  If you start this program from ConnectTHOR,
  130. ConnectTHOR  will  update  its  internal  variables  to reflect on the
  131. configuration saved.
  132.  
  133. -> Cancel
  134. Cancel the changes and quit the CfgTCP program.
  135.  
  136. -----------------------
  137.  
  138. -  When  you  have configured the various options described above, you
  139. must  use the "join" option from the events menu or the dock window in
  140. THOR  to  select  which  conferences  to  collect  news from.  This is
  141. required  even  if you received several groups previously with UUCP or
  142. SOUP.
  143.  
  144. -  You  must  send the events to actually subscribe to the groups from
  145. the newsserver.  See below for a description.
  146.  
  147. ConnectTHOR
  148. ~~~~~~~~~~~
  149. This  is  the GUI based program that can be used for those who like to
  150. have a nice and easy to use GUI for controlling the process or getting
  151. and  sending news/mail.  ConnectTHOR will integrade the shell programs
  152. GetTCP  and  SendTCP,  and  even provides for a separate news browser.
  153. The following options is available in ConnectTHOR:
  154.  
  155. -> Do All
  156. Will send off any events you might have pending, collect mail and then
  157. news, all in one process.
  158.  
  159. -> Get Mail
  160. Will get only mail from the configured POP3 server (the mailserver) by
  161. calling the separate GetTCP program with the NONEWS option.
  162.  
  163. -> Get News
  164. Will  get  only  news  from  the configured news server by calling the
  165. separate GetTCP program with the NOMAIL option.
  166.  
  167. -> Send Events
  168. Will  send  off  any  mail  and  news  you have written by calling the
  169. separate  SendTCP  program.   If you do not use the "Do All" function,
  170. this function must be used when you have joined or resigned newsgroups
  171. in  THOR.   Be  selecting  "Get  Conf.list"  in  THOR,  you can have a
  172. complete  list of newsgroups sent to you.  This list will be used when
  173. joining groups in THOR.
  174.  
  175. -> Config TCP
  176. Configuration  of  mail  and  news  options.  See above for a detailed
  177. description.
  178.  
  179. -> Browse News
  180. ******* Missing description **************
  181.  
  182. --------------
  183.  
  184. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! NOTE !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  185.  
  186. - DO NOT READ MESSAGES WHILE COLLECTING MAIL AND NEWS DUE TO A BUG IN
  187. THE BUFFER HANDLING IN BBSREAD.LIBRARY. THIS WILL BE FIXED IN BETA 5.
  188.  
  189. -  Beta  4  requires  the included utgui.library upgrade.  If you have
  190. problems   getting  them  to  work,  reboot  (or  make  sure  the  old
  191. utgui.library is flushed out of memory), then try again.
  192.  
  193. -  You  must  join  all  newsgroups you want news in from within THOR.
  194. Then  you  must  start  SendTCP  (or  select  Send  Events from within
  195. ConnectTHOR)  while  online.   This also applies to any conference you
  196. might have received news in when using UUCP/SOUP/InetUtils.
  197.  
  198. - The first time you use GetTCP (or select Get News from ConnectTHOR),
  199. only news from the last 24 hours are collected (this can be overridden
  200. by  setting  the  date on CfgTCP (or Config TCP from ConnectTHOR).  If
  201. you  receive  duplicates  this first time, run Delete Dups from within
  202. THOR.
  203.  
  204. - Parameters supplied in tooltypes or as command line parameters will
  205. override configuration settings.
  206.  
  207.  
  208. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  209.  
  210. History
  211. ~~~~~~~
  212. Beta 2:
  213. -------
  214. - ConnectTHOR would leave the ghosting on several gadgets after
  215.   selecting to send events, get news or get mail. Fixed.
  216. - ConnectTHOR will not allow you to open several NewsBrowse windows
  217.   anymore. 
  218. - Fixed an mismatched Permit() in GetTCP that could cause problems.
  219.  
  220. Beta 3:
  221. -------
  222. ConnectTHOR:
  223. - The newsbrowser will work on non-INN newsservers too now, but only
  224.   message number and subject will be viewable. This should handle
  225.   most, if not all newsserver software out there.
  226. - Will use the "Delete mail" configuration option properly now and not
  227.   delete mail from the pophost if it isn't configured to do so.
  228. - A hotlist will be updated automatically when getting headers from
  229.   group in the newsbrowser. This hotlist will be saved to disk when
  230.   quitting, and will also contain the highest message number from the
  231.   last time you collected news, so you can start from that number
  232.   the next time.
  233.  
  234. GetTCP:
  235. - Would not behave correctly with commas (,) in the to-field.
  236. - Handing Forbid() fixed. This caused all of the problems when GetTCP
  237.   was quitting.
  238. - Will automatically split the type of digest used on eg. the AMosaic
  239.   list.
  240. - base64 MIME encoded binaries are handled correctly again. Text will be
  241.   shown in the listview, while binaries will be put on disk in the 
  242.   decoded/ dir.
  243. - Command line template fixed.
  244.  
  245. SendTCP:
  246. - Should work on all mailservers now.
  247.  
  248. CfgTCP:
  249. - Max Days will be handled correctly when loading the config again.
  250.  
  251. Beta 4:
  252. -------
  253. ConnectTHOR:
  254. - Fixed the problem with ConnectTHOR asking for a password upon startup
  255.   even though the password had been configured already.
  256. - Fixed the DELETE switch problem once and for all (hopefully).
  257. - MAXDAYS wasn't working correctly, should be fixed now.
  258. - Configured POPPORT will be used.
  259. - Configured background window picture will be used.
  260. - Error messages should be displayed properly.
  261. - Fixed a reference to freed memory when closing the newsbrowse window.
  262.  
  263. CfgTCP:
  264. - Fixed a crash when quitting when Mungwall was running (used freed
  265.   memory).
  266. - Configured background window picture will be used.
  267. - POP port can be configured to something else than 110, if needed.
  268.  
  269. GetTCP:
  270. - "failure when adding message"-bug fixed. This one also gave
  271.   an Enforcer hit.
  272. - Should work better with all kinds of pop hosts.
  273. - Will get the time from the newsserver so local clock will not
  274.   be used (this was actually done in beta 3, but left out of the history
  275.   file :).
  276. - POP Port can be set on the command line, if started from shell.
  277. - Will exit when password has been entered wrong (when run from shell).
  278.  
  279. SendTCP:
  280. - Fixed a bug that could make it stop on some SMTP servers.
  281.  
  282. --------
  283. PS: Please report any problems to thor@hstud6.cs.uit.no (THOR team)
  284.  
  285. The authors can also reached the following ways:
  286.  
  287. Kjell Irgens:
  288.  
  289.      email: kjelli@stud.cs.uit.no
  290. IRC #amiga: Trooper1
  291.  
  292. Petter Nilsen:
  293.  
  294.      email: pettern@powertech.no
  295. IRC #amiga: Mitchman
  296.